<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkTipsQuery</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
<link rel="home" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkTooltips.html" title="GtkTooltips">
<link rel="next" href="GtkTree.html" title="GtkTree">
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="Builder.html" title="Interface builder">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="chapter" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder">
<link rel="chapter" href="gtk-migrating-tooltips.html" title="Migrating from GtkTooltips to GtkTooltip">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="api-index-full.html" title="Index of all symbols">
<link rel="index" href="api-index-deprecated.html" title="Index of deprecated symbols">
<link rel="index" href="api-index-2-2.html" title="Index of new symbols in 2.2">
<link rel="index" href="api-index-2-4.html" title="Index of new symbols in 2.4">
<link rel="index" href="api-index-2-6.html" title="Index of new symbols in 2.6">
<link rel="index" href="api-index-2-8.html" title="Index of new symbols in 2.8">
<link rel="index" href="api-index-2-10.html" title="Index of new symbols in 2.10">
<link rel="index" href="api-index-2-12.html" title="Index of new symbols in 2.12">
<link rel="index" href="api-index-2-14.html" title="Index of new symbols in 2.14">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkTooltips.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkTree.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#GtkTipsQuery.synopsis" class="shortcut">Top</a>
                 | 
                <a href="#GtkTipsQuery.description" class="shortcut">Description</a>
                 | 
                <a href="#GtkTipsQuery.object-hierarchy" class="shortcut">Object Hierarchy</a>
                 | 
                <a href="#GtkTipsQuery.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
                 | 
                <a href="#GtkTipsQuery.properties" class="shortcut">Properties</a>
                 | 
                <a href="#GtkTipsQuery.signals" class="shortcut">Signals</a>
</td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkTipsQuery"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkTipsQuery.top_of_page"></a>GtkTipsQuery</span></h2>
<p>GtkTipsQuery — Displays help about widgets in the user interface</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="GtkTipsQuery.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">

#include &lt;gtk/gtk.h&gt;

                    <a class="link" href="GtkTipsQuery.html#GtkTipsQuery-struct" title="GtkTipsQuery">GtkTipsQuery</a>;
<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a class="link" href="GtkTipsQuery.html#gtk-tips-query-new" title="gtk_tips_query_new ()">gtk_tips_query_new</a>                  (void);
void                <a class="link" href="GtkTipsQuery.html#gtk-tips-query-start-query" title="gtk_tips_query_start_query ()">gtk_tips_query_start_query</a>          (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tips_query);
void                <a class="link" href="GtkTipsQuery.html#gtk-tips-query-stop-query" title="gtk_tips_query_stop_query ()">gtk_tips_query_stop_query</a>           (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tips_query);
void                <a class="link" href="GtkTipsQuery.html#gtk-tips-query-set-caller" title="gtk_tips_query_set_caller ()">gtk_tips_query_set_caller</a>           (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tips_query,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *caller);
void                <a class="link" href="GtkTipsQuery.html#gtk-tips-query-set-labels" title="gtk_tips_query_set_labels ()">gtk_tips_query_set_labels</a>           (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tips_query,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *label_inactive,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *label_no_tip);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkTipsQuery.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
  <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
   +----<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
                     +----<a class="link" href="GtkMisc.html" title="GtkMisc">GtkMisc</a>
                           +----<a class="link" href="GtkLabel.html" title="GtkLabel">GtkLabel</a>
                                 +----GtkTipsQuery
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkTipsQuery.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkTipsQuery implements
 AtkImplementorIface and  <a class="link" href="gtk-gtkbuildable.html#GtkBuildable">GtkBuildable</a>.</p>
</div>
<div class="refsect1" lang="en">
<a name="GtkTipsQuery.properties"></a><h2>Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery--caller" title='The "caller" property'>caller</a>"                   <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*            : Read / Write
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery--emit-always" title='The "emit-always" property'>emit-always</a>"              <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery--label-inactive" title='The "label-inactive" property'>label-inactive</a>"           <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery--label-no-tip" title='The "label-no-tip" property'>label-no-tip</a>"             <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkTipsQuery.signals"></a><h2>Signals</h2>
<pre class="synopsis">
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery-start-query" title='The "start-query" signal'>start-query</a>"                                    : Run First
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery-stop-query" title='The "stop-query" signal'>stop-query</a>"                                     : Run First
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery-widget-entered" title='The "widget-entered" signal'>widget-entered</a>"                                 : Run Last
  "<a class="link" href="GtkTipsQuery.html#GtkTipsQuery-widget-selected" title='The "widget-selected" signal'>widget-selected</a>"                                : Run Last
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkTipsQuery.description"></a><h2>Description</h2>
<p>
The <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> widget is a subclass of <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> which is used to display
help about widgets in a user interface.
</p>
<p>
A query is started with a call to <a class="link" href="GtkTipsQuery.html#gtk-tips-query-start-query" title="gtk_tips_query_start_query ()"><code class="function">gtk_tips_query_start_query()</code></a>, usually
when some kind of 'Help' button is pressed. The <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> then grabs all
events, stopping the user interface from functioning normally.
Then as the user moves the mouse over the widgets, the <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> displays
each widget's tooltip text.
</p>
<p>
By connecting to the "widget-entered" or "widget-selected" signals, it is
possible to customize the <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> to perform other actions when widgets
are entered or selected. For example, a help browser could be opened with
documentation on the widget selected.
</p>
<p>
At some point a call to <a class="link" href="GtkTipsQuery.html#gtk-tips-query-stop-query" title="gtk_tips_query_stop_query ()"><code class="function">gtk_tips_query_stop_query()</code></a> must be made in order to
stop the query and return the interface to its normal state.
The <a class="link" href="GtkTipsQuery.html#gtk-tips-query-set-caller" title="gtk_tips_query_set_caller ()"><code class="function">gtk_tips_query_set_caller()</code></a> function can be used to specify a widget
which the user can select to stop the query (often the same button used to
start the query).
</p>
</div>
<div class="refsect1" lang="en">
<a name="GtkTipsQuery.details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="GtkTipsQuery-struct"></a><h3>GtkTipsQuery</h3>
<pre class="programlisting">typedef struct _GtkTipsQuery GtkTipsQuery;</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkTipsQuery</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
The <a class="link" href="GtkTipsQuery.html#GtkTipsQuery-struct" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> struct contains private data only, and
should be accessed using the functions below.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-tips-query-new"></a><h3>gtk_tips_query_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_tips_query_new                  (void);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tips_query_new</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Creates a new <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a new <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-tips-query-start-query"></a><h3>gtk_tips_query_start_query ()</h3>
<pre class="programlisting">void                gtk_tips_query_start_query          (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tips_query);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tips_query_start_query</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Starts a query.
The <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> widget will take control of the mouse and as the mouse
moves it will display the tooltip of the widget beneath the mouse.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>tips_query</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-tips-query-stop-query"></a><h3>gtk_tips_query_stop_query ()</h3>
<pre class="programlisting">void                gtk_tips_query_stop_query           (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tips_query);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tips_query_stop_query</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Stops a query.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>tips_query</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-tips-query-set-caller"></a><h3>gtk_tips_query_set_caller ()</h3>
<pre class="programlisting">void                gtk_tips_query_set_caller           (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tips_query,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *caller);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tips_query_set_caller</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the widget which initiates the query, usually a button.
If the <em class="parameter"><code>caller</code></em> is selected while the query is running, the query is
automatically stopped.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tips_query</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>caller</code></em> :</span></p></td>
<td>the widget which initiates the query.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-tips-query-set-labels"></a><h3>gtk_tips_query_set_labels ()</h3>
<pre class="programlisting">void                gtk_tips_query_set_labels           (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tips_query,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *label_inactive,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *label_no_tip);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_tips_query_set_labels</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the text to display when the query is not in effect,
and the text to display when the query is in effect but the widget beneath
the pointer has no tooltip.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tips_query</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>label_inactive</code></em> :</span></p></td>
<td>the text to display when the query is not running.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>label_no_tip</code></em> :</span></p></td>
<td>the text to display when the query is running but the widget
beneath the pointer has no tooltip.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GtkTipsQuery.property-details"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="GtkTipsQuery--caller"></a><h3>The <code class="literal">"caller"</code> property</h3>
<pre class="programlisting">  "caller"                   <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*            : Read / Write</pre>
<p>
The widget that starts the tips query, usually a button.
If it is selected while the query is in effect the query is automatically
stopped.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkTipsQuery--emit-always"></a><h3>The <code class="literal">"emit-always"</code> property</h3>
<pre class="programlisting">  "emit-always"              <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>
<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
><code class="literal">TRUE</code></a> if the widget-entered and widget-selected signals are emitted even when
the widget has no tooltip set.
</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkTipsQuery--label-inactive"></a><h3>The <code class="literal">"label-inactive"</code> property</h3>
<pre class="programlisting">  "label-inactive"           <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write</pre>
<p>
The text to display in the <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> widget when the query is not in
effect.
</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkTipsQuery--label-no-tip"></a><h3>The <code class="literal">"label-no-tip"</code> property</h3>
<pre class="programlisting">  "label-no-tip"             <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*                : Read / Write</pre>
<p>
The text to display in the <a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a> widget when the query is running
and the widget that the pointer is over has no tooltip.
</p>
<p>Default value: NULL</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GtkTipsQuery.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="GtkTipsQuery-start-query"></a><h3>The <code class="literal">"start-query"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tipsquery,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run First</pre>
<p>
Emitted when the query is started.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkTipsQuery-stop-query"></a><h3>The <code class="literal">"stop-query"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tipsquery,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run First</pre>
<p>
Emitted when the query is stopped.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkTipsQuery-widget-entered"></a><h3>The <code class="literal">"widget-entered"</code> signal</h3>
<pre class="programlisting">void                user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a> *tipsquery,
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>    *widget,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>        *tip_text,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>        *tip_private,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)        : Run Last</pre>
<p>
Emitted when a widget is entered by the pointer while the query is in effect.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>the widget that was entered by the pointer.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_text</code></em> :</span></p></td>
<td>the widget's tooltip.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_private</code></em> :</span></p></td>
<td>the widget's private tooltip (see <a class="link" href="GtkTooltips.html#gtk-tooltips-set-tip" title="gtk_tooltips_set_tip ()"><code class="function">gtk_tooltips_set_tip()</code></a>).
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkTipsQuery-widget-selected"></a><h3>The <code class="literal">"widget-selected"</code> signal</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            user_function                      (<a class="link" href="GtkTipsQuery.html" title="GtkTipsQuery">GtkTipsQuery</a>   *tipsquery,
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>      *widget,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>          *tip_text,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>          *tip_private,
                                                        <a
href="/usr/share/gtk-doc/html/gdk/gdk-Event-Structures.html#GdkEventButton"
>GdkEventButton</a> *event,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)        : Run Last</pre>
<p>
Emitted when a widget is selected during a query.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>tipsquery</code></em> :</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>the widget that was selected.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_text</code></em> :</span></p></td>
<td>the widget's tooltip.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>tip_private</code></em> :</span></p></td>
<td>the widget's private tooltip (see <a class="link" href="GtkTooltips.html#gtk-tooltips-set-tip" title="gtk_tooltips_set_tip ()"><code class="function">gtk_tooltips_set_tip()</code></a>).
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td>
<td>the button press or button release event.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>%TRUE if the query should be stopped.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="GtkTipsQuery.see-also"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><a class="link" href="GtkTooltips.html" title="GtkTooltips"><span class="type">GtkTooltips</span></a></span></p></td>
<td><p>the object which handles tooltips.</p></td>
</tr></tbody>
</table></div>
<p>
</p>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.11</div>
</body>
</html>
